Sending and receiving information
When invoking external services from Bizagi, by relying on the WS Connector you may easily your input or output parameters.
Un-mapped information
It is strongly recommended that you map all the information relevant to the shown parameters of your web service (especially those published as input parameters), otherwise default values for those parameters left un-mapped may not suit your external service's expectations.
Default values for un-mapped parameters will be sent by Bizagi as NULL values by the WS connector.
There is an exception to this rule, that applies only when processes run in a .NET platform which is:
If a parameter is defined as non nullable (nullable=false), then the .NET framework will assign a default value for that specific data type.
In the case of primitive data types such as boolean or integers, the default values provided by the .NET framework are false and zero respectively.
Mapped information
The graphical mapping of the WS Connector allows you to easily manipulate certain types of information.
For more information about this, refer to:
•Sending and receiving files (attachments)
•Sending and receiving dates (formatting)
Sending and receiving dates
When invoking external services from Bizagi, by relying on the WS Connector you may easily map datetime (date) attributes as input or output parameters.
Datetime attributes are handled automatically by the graphical mapping feature of the WS Connector, and formatted into standard datetime notation for best practices in XML interoperability.
The default datetime format involved in Bizagi when connecting to external web services is:
YYYY-MM-DDTHH:mm:ss
Similarly, in web services' responses the underlying framework will format by default a datetime to the YYYY-MM-DDTHH:mm:ss format, though it is strongly recommended to make sure that you web service explicitly complies with this best practice and sends out dates in such format.
In case you need to customize or reformat a date, you may rely on the Format date mapping function available in the WS Connector.
For more information about this possibility, refer to Mapping functions.